<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>IupCbox</title>
<link rel="stylesheet" type="text/css" href="../../style.css">
</head>
<body>
<div id="navigation">
  <ul>
    <li><a href="#Creation">Creation</a></li>
    <li><a href="#Attributes">Attributes</a></li>
    <li><a href="#Callbacks">Callbacks</a></li>
    <li><a href="#Notes">Notes</a></li>
    <li><a href="#Examples">Examples</a></li>
    <li><a href="#SeeAlso">See Also</a></li>
  </ul>
</div>

<h2>IupCbox</h2>
<p>Creates a 
  void container for position elements in absolute coordinates. It is a <strong>concrete</strong> layout container.</p>
<p>It does not have a native representation.</p>
<p>The <strong>IupCbox</strong> is equivalent of a <strong>IupVbox</strong> or
<strong>IupHbox</strong> where all the children have the
<a href="../attrib/iup_floating.html">FLOATING</a> attribute set to YES, but 
children must use CX and CY attributes instead of the POSITION attribute.</p>
<h3><a name="Creation">Creation</a></h3>
<div>
  <pre>Ihandle* IupCbox(Ihandle*<strong> child</strong>, ...); [in C]
Ihandle* IupCboxv(Ihandle*<strong>* children</strong>); [in C]
iup.cbox{<strong>child</strong>, ...: ihandle} -&gt; (<strong>elem</strong>: ihandle) [in Lua]
cbox(<strong>child</strong>, ...) [in LED]</pre>
</div>
  <p><strong>child</strong>, ... :
  List of the identifiers that will be placed 
  in the box. NULL must be used to define the end of the list in C. It can be empty.</p>
  <p>
  <u>Returns:</u> the identifier of the 
  created element, or NULL if an error occurs.</p>

<h3><a name="Attributes">Attributes</a></h3>


  <p><a href="../attrib/iup_expand.html">EXPAND</a> (<font SIZE="3">non inheritable</font>):
  The default value is &quot;YES&quot;.</p>
<p><a href="../attrib/iup_size.html">SIZE</a> /
<a href="../attrib/iup_rastersize.html">RASTERSIZE</a> (<font SIZE="3">non 
inheritable</font>): Must be defined for each child. If not defined for the box, 
then it will be the bounding box that includes all children in their position.</p>

  <p><b>WID</b> (read-only): returns -1 if mapped.</p>

  <blockquote>
    <hr>
</blockquote>

  <p>
<a href="../attrib/iup_font.html">FONT</a>,
    <a href="../attrib/iup_clientsize.html">CLIENTSIZE</a>, 
	<a href="../attrib/iup_clientoffset.html">CLIENTOFFSET</a>, 
	<a href="../attrib/iup_position.html">POSITION</a>, 
<a href="../attrib/iup_minsize.html">
MINSIZE</a>, <a href="../attrib/iup_maxsize.html">
MAXSIZE</a>: 
also accepted.</p>

<h3>Attributes (at Children)</h3>


<p><strong>CX, CY</strong> (non inheritable) <strong>(at children only)</strong>: Position in pixels 
of the child relative to the 
  top-left corner of the box. Must be set for each child inside the box.</p>

<h3><a name="Notes">Notes</a></h3>

<p>The box can be created with no elements and be dynamic filled using
  <a href="../func/iupappend.html">IupAppend</a> or
<a href="../func/iupinsert.html">IupInsert</a>.</p>

<h3><a name="Examples">Examples</a></h3>
<p><a href="../../examples/">Browse for Example Files</a></p>
<h3><a name="SeeAlso">See Also</a></h3>

<p><a href="iupvbox.html">IupVbox</a>, <a href="iuphbox.html">
IupHbox</a></p>

</body>

</html>
